home *** CD-ROM | disk | FTP | other *** search
/ Giga Games 1 / Giga Games.iso / net / go / prog / gs109sit.hqx / gs1.00.update < prev    next >
Encoding:
Text File  |  1993-02-09  |  10.4 KB  |  231 lines
  1. This document describes the changes made to GoServant from version
  2. 0.60->0.70->0.72->1.00. Users of older versions may read this to
  3. become familiar with the new features. New users should READ THE
  4. GS0.60.DOC FILE FIRST!! PLEASE!! (Particularly the first secion of
  5. that manual.)
  6.  
  7.  
  8. GoServant 0.70 Additions
  9. ========================
  10.  
  11. 1) Client mode
  12.  
  13. GoServant 0.70 now handles client mode, so you can "toggle client on"
  14. and it will work. The major (only?) advantage to this is that non-
  15. verbose moves will contain the time remaining for each player, and 
  16. GoServant will process these time values (see section 2). Everything
  17. in client mode will look the same, except that there will be numbers
  18. at the start of most lines (just ignore them), and you will no longer
  19. see the "#>" prompt. Instead, a line beginning with 1 is the prompt.
  20. In particular, when logging on, you will NOT see "Password:" if you 
  21. have client mode on. Instead, you will see "1 1". Type your password
  22. as soon as you see this.
  23.  
  24. 2) Time clocks
  25.  
  26. GoServant 0.70 will now display running time clocks for any game. You
  27. MUST be using either client mode or verbose mode for them to operate
  28. (I suggest client mode, for obvious reasons). In the dialog box that
  29. appears when you create a new board window, check the "Show captives/
  30. score/time" box. A time display, with running clocks, will appear 
  31. below the board, along with the captives. Whenever a move is received,
  32. these clocks will be updated, and this may cause them to jump around
  33. a bit. This is due to net-lag and cannot be avoided. Remember that the
  34. times shown are ESTIMATES and are not 100% accurate. If you do not like
  35. to see a ticking clock all the time, you may use the "Hide Clocks" menu
  36. item under the "Board" menu (or more likely command-T (for "time")) to
  37. make them disappear. They will still be running, though, and at any time
  38. you can use "Show Clocks" (command-T again) to take a quick peek at 
  39. them. This is much faster, easier, and more accurate than typing the
  40. "time" command to the server. Speaking of the "time" command, GoServant
  41. will NOT recognize the output from that command. Use "refresh" instead
  42. if you want the clocks updated.
  43.  
  44. NOTE: Tim has said that the clock information will soon be added to moves
  45. even in non-client mode. When that happens, you will no longer need to 
  46. use client mode, and in fact there will be no reason to do so.
  47.  
  48. GoServant 0.72 Additions
  49. ========================
  50.  
  51. 3) Dialogs
  52.  
  53. The first editable text item is now automatically selected in all dialogs, so
  54. that you can, for example, type command-O,4,<return> to quickly observe game 4
  55. with no mouse needed. The OK button is circled to show what will happen if
  56. return is pressed, and tab will select the next editable text field.
  57.  
  58. 4) Windows menu
  59.  
  60. There is now a windows menu. Selecting the name of a window will bring that
  61. window to the top. One of the windows is an "input" window, which is
  62. described later.
  63.  
  64. 5) Plain serial port use
  65.  
  66. There is now an option (in the serial settings dialog) which will prevent
  67. GoServant from closing the serial ports when it quits. The settings dialog
  68. can also be called up at any time with the "Serial Port Parms..." item in
  69. the Terminal menu (but you cannot switch ports at that time, nor choose
  70. "do not set parameters when opening", for obvious reasons).
  71.  
  72. GoServant 1.00 Additions
  73. ========================
  74.  
  75. 6) Background use
  76.  
  77. GS should now keep running even if it is not the front application. Windows will
  78. be updated and moves made even in the background.
  79.  
  80. 7) Saving Smart Go files
  81.  
  82. Any board window may be saved into a Smart Go file. Only the board size, handicap
  83. stones, and moves (including passes) will be saved. NOTE: As for the undo command,
  84. GS can only save (or undo) moves that IT HAS SEEN PLAYED. This does NOT include
  85. stones that appeared on the board as the result of a verbose board refresh. To
  86. get a proper record of the moves that can be saved, you MUST use "moves" and 
  87. NOT "toggle verbose/refresh/toggle verbose" to initialize the board. 
  88.  
  89. 8) Changing board windows at any time
  90.  
  91. The "Board Info.." item under the Board menu will now allow you to change the
  92. size, scale, move number, komi, coordinates, icons, and captives/clocks of any
  93. board window at any time. The window will be resized and redrawn. NOTE: Adjusting
  94. the size of the board (eg. from 19x19 to 13x13) is hazardous. Do this at your
  95. own risk. Adjusting the "scale" (making the stones larger or smaller) is OK.
  96.  
  97. 9) Break
  98.  
  99. The "Send Break" item in the Terminal menu (or command-Y) will now send a
  100. "break" signal.
  101.  
  102. 10) Input window
  103.  
  104. There is now an input buffer window which can be used to type and edit lines to be
  105. sent to the server without having them interrupted by incoming data. To open this
  106. window, choose "Input" from the Windows menu (or use command-I). A very short and
  107. wide window will appear at the top of the screen. It can be closed by using the
  108. "Close" item in the File menu (there is no go away box). It can be moved by dragging
  109. the '#>' symbol on the left end. It can be resized, but only in a horizontal
  110. direction. If this window is in front of the terminal window, all typing will
  111. take place in this window. The usual Macintosh editing operations, including
  112. cut/copy/paste are supported. Whenever return is pressed, the contents of this
  113. window will be sent to the terminal window. (If the terminal window is in front
  114. of the input window, however, then all typing will again go directly to the
  115. terminal window and the input window will be dormant.)
  116.  
  117. 11) Echo When Pasting
  118.  
  119. When a terminal tool is being used, GS has no way of knowing whether or not
  120. local echoing of characters is required. When then contents of the input window
  121. or the clipboard are sned/pasted to the terminal window, the "Echo When Pasting"
  122. option in the Terminal menu will control whether or not these characters are
  123. echoed locally. If you see such characters twice, or not at all, simply toggle
  124. this item. (This item is only enabled and needed when a terminal tool is used.)
  125.  
  126. 12) Macros
  127.  
  128. There are now 10 user-definable macros available. The "Set Macros..." item under
  129. the Goodies menu can be used to set them to whatever you like. Each macro may have
  130. up to 254 characters, and may include return characters. (Although you should be
  131. warned that sending a sequence of commands to the server like "toggle verbose",
  132. "refresh", "toggle verbose" does NOT work reliably with the current version of
  133. the server.) You can then select a macro using the Goodies menu, or use the
  134. command-digit equivalents. When you do, that macro will be pasted to either the
  135. input or terminal window (whichever is frontmost). If the macro contains returns,
  136. then the returns and any characters in front of them will not stay in the input
  137. window, but will be passed on to the terminal immediately. (It acts exactly
  138. as if you had typed those characters.)
  139.  
  140. 13) Colour and Sound
  141.  
  142. GS now supports colour boards and stones, and will use sounds for stone clicks
  143. ("plonks") and "atari" if desired. These features may be enabled or disabled
  144. by the top four items in the Goodies menu. If you don't like the colours or the
  145. sounds, you can customize them by changing the appropriate resources in the
  146. GoServant file using ResEdit. (If you know how to do that, of course.)
  147. There is also a monochrome pattern for the board which is used if colour is
  148. unavailable or disabled, which is currently all white. You can also change that one
  149. if you like (but I've never found one that I like better than white.) I won't
  150. tell you which resources they are. Finding them is half the fun. :-)
  151.  
  152. 14) Retry Communications
  153.  
  154. When communications do not open properly when GS is first started, you are now
  155. given the option of trying again.
  156.  
  157. 15) Unobserve
  158.  
  159. When a window which is being used to observe a game is closed, GS now issues
  160. an "unobserve" command automatically.
  161.  
  162. 16) Separate play/observe defaults
  163.  
  164. There are now two sets of default settings for the board window, one for the
  165. playing window, and another for observing windows.
  166.  
  167. 17) Automatic "moves" command
  168.  
  169. When you start observing a game, you now have an option in the dialog that
  170. appears which will cause a "moves" command to be sent to the server to
  171. initialize the board. (The alternative of "toggle verbose" and "refresh" is
  172. not possible at the current time, and it also does not allow proper undoing
  173. of moves, or saving of the window in Smart Go format.) NOTE: You will likely
  174. want to turn off the sounds before doing this. Otherwise all of the old
  175. moves wil make "click" and "atari" sounds, too.
  176.  
  177. 18) Bug fixes
  178.  
  179. Several bugs were found and fixed, particularly in the scroll bars and in
  180. the mode icons (does anyone actually use those?).
  181.  
  182. 19) New Telnet Tool
  183.  
  184. For users with a Macintosh connected directly to a network, I am happy to 
  185. report that there is a public domain telnet tool which will allow you use
  186. GoServant in that situation. (The VersaTerm Telnet Tool also works, but it
  187. is a commercial software product.) The free one is the "TGE TCP Tool" and
  188. it can be found at several ftp sites:
  189.  
  190. Host plaza.aarnet.edu.au
  191.  
  192.     Location: /micros/mac/umich/system.extensions/commtoolbox
  193.            FILE -r--r--r--      24206  Oct  3 02:54  tgetcptool1.0v1.cpt.hqx
  194.  
  195. Host nigel.msen.com
  196.  
  197.     Location: /pub/vendor/ice
  198.            FILE -rw-r--r--      24206  Sep 30 18:30  TGETCPTool.hqx
  199.  
  200. Host quepasa.cs.tu-berlin.de
  201.  
  202.     Location: /pub/mac/sys/comm
  203.            FILE -rw-rw-r--      17920  Oct 23 01:45  TGETCPTool.cpt.bin
  204.            FILE -rw-rw-r--        841  Oct 23 01:45  TGETCPTool.intro
  205.  
  206. Host wuarchive.wustl.edu
  207.  
  208.     Location: /mirrors2/rascal.ics.utexas.edu/communications
  209.            FILE -r--r--r--        881  Sep 30 17:19  TGETCPTool_intro
  210.     Location: /mirrors3/archive.umich.edu/mac/system.extensions/commtoolbox
  211.            FILE -r--r--r--      24206  Oct  2 21:54  tgetcptool1.0v1.cpt.hqx
  212.  
  213. Host ftp.luth.se
  214.  
  215.     Location: /pub/OS/mac/comm/toolbox
  216.            FILE -rw-r--r--      17920  Dec 18 17:29  TGETCPTool.cpt.bin
  217.  
  218. ==================================
  219. Have fun with GoServant 1.00. Except for bug fixes, this will probably be the
  220. last upgrade for quite a while. I have implemented almost everything that was
  221. on my "to do" list, and I consider it to be completed. The only other feature
  222. that was requested was the ability to scroll backwards and forwards through 
  223. the moves in a game. This is a difficult feature to implement reliably without
  224. effectively rewriting most of the Smart Go program and including it as part
  225. of GoServant. That would be an awful lot of work. Someday I may implement this
  226. feature, but it will not be soon. Sorry.
  227. ==================================
  228.  
  229. John Bate
  230. bate@cs.umanitoba.ca
  231.